home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 21 / AMIGAplus Sonderheft 21 (1999)(ICP)(DE)[!].iso / PublicDomain / System / httplister / HTTPlister.readme next >
Text File  |  1999-08-23  |  7KB  |  184 lines
  1.   *** Readme for setup & running of HTTPlister.rexx V2.0 ***
  2.  
  3. V2.0 changes:
  4.  
  5.    New buttons
  6.    UnSelect/ReSelect
  7.    PreSelect
  8.    Download RECENT
  9.  
  10.    Descriptions for these are below under 'The Buttons'.
  11.  
  12.    To facilitate the change from earlier versions of HTTPlister.rexx
  13.    to V2.0 go to the 'Setting up' section below. 
  14.  
  15.    This applies to setting it up for the first time also.
  16.  
  17.             -------------------------------
  18.  
  19.                 Brief Description
  20.  
  21.   You will need HTTPResume, also found on aminet (comm/www) for
  22.   this to work.
  23.   
  24.   Once you have done the small amount of setting up outlined below
  25.   you will be able to list the entire contents of the Aminet RECENT
  26.   file in a Dopus lister (optionally minus the aminet file dirs you
  27.   don't want listed) and to select any number of files and download
  28.   them.
  29.   
  30.   You'll also be able to select/download and read readme files.
  31.   
  32.             -------------------------------
  33.  
  34. Downloading files.,
  35.    The initial download directory is RAM: as set by the variable 'DDir'.
  36.  
  37.    You download the files by clicking on them once in the lister and
  38.    then selecting the Download Selected button.
  39.  
  40.    Alternatively you can Drag & Drop them into a destination lister.
  41.    That will cause that lister to be the new download directory.
  42.  
  43.    The URL for downloading files from can be changed by selecting the
  44.    Change URL button.
  45.  
  46.    Because the most likely time to encounter download troubles is
  47.    during the downloading of large files with the posibility of
  48.    missing the smaller files, the selected files are downloaded from
  49.    smallest to largest.
  50.  
  51.    Downloaded files of the same name overwrite the ones in the
  52.    download directory.
  53.  
  54.    An HTTPdebug.log file is written to the download directory.
  55.  
  56. Readme files.,
  57.    To read the .readme for a file hold down the SHIFT key and
  58.    DOUBLECLICK the file.
  59.  
  60.    Or hold down the SHIFT and Drag & Drop the file into a destination
  61.    lister, that will also make that lister the current download
  62.    directory - all future downloads will go there; that is until
  63.    there's another Drag & Drop to somewhere else.
  64.  
  65.    Only get ONE readme file at a time.
  66.  
  67. To get this going, pass a listing file to this script by either selecting
  68.    the listing (RECENT) file in a lister and then run this script OR pass
  69.    the listing file with it's path to this script as an argument when
  70.    running it.
  71.  
  72.    When you've finished with a listing you can get another listing into
  73.    the lister by Drag & Drop or run this script again passing the listing 
  74.    file to it as mentioned.
  75.  
  76.    When you run this script from a Dopus menu etc. set the flag
  77.     Run asynchronously.
  78.  
  79. The lister.,
  80.    Each button in the lister has a keyboard alternative as per the
  81.    under-scored character in the text of each button plus the control
  82.    character as the qualifier.
  83.  
  84.    By selecting either of the listers column labels 'Name' or 'Comment'
  85.    the list can be sorted either by file name or by aminet directory.
  86.  
  87.    Selecting the 'Date' label in the lister gets all the lines sorted in
  88.    the same order as they were in the file they came from. (The 'dates'
  89.    are meaningless - generated for sorting purposes only).
  90.  
  91.    It is actually the 'time' part of the date field that gets incremented,
  92.    the dates remain constant.
  93.  
  94.    There are 3 sorting methods for the Date field, select the 'Date' label
  95.    3 times to see which one you want.
  96.  
  97.    o The most downloaded files from Aminet during the week have the date:
  98.      22-Feb-88.
  99.  
  100.    o The highest rated programs during the week have the date:
  101.      30-Mar-98.
  102.  
  103.    o The rest have the date:
  104.      01-Jan-78.
  105.  
  106.    Message of the day, if there is one, gets displayed as the list is loaded.
  107.  
  108.                        ---------------------
  109.  
  110.                          The Buttons
  111.  
  112.    Download:
  113.    Selected:  Downloads the selected files.
  114.            
  115.    UnSelect:
  116.    ReSelect:  Toggles between Selected & UnSelected.
  117.  
  118.    Search:
  119.    Lister:    Searches Name & Comment columns for some text.
  120.  
  121.    PreSelect: This is handy for choosing files while off line and having them
  122.               re-selected automatically when the RECENT file is loaded again.
  123.  
  124.               Clicking this button saves the names of the selected files for
  125.               re-selection when the RECENT file is again loaded into the lister.
  126.               Only when ALL the PreSelected file names are re-selected is the
  127.               PreSelected memory of the file names removed. So that if a
  128.               different RECENT  file is  loaded in  with only  some  of the
  129.               PreSelected file names in it they will still be selected but the
  130.               memory of all the PreSelected names will still be there for when
  131.               the original RECENT file is loaded into the lister.
  132.               Clicking PreSelect again during the same session (WITHOUT any files
  133.               currently selected) re-selects the PreSelected files.
  134.  
  135.    Download:
  136.     RECENT :  Downloads and loads (into the lister) a RECENT file from the
  137.               current URL.
  138.  
  139.    Change:
  140.      URL :    Changes URL and briefly displays it in the window title bar.
  141.               Right Mouse button on this shows the current URL.
  142.  
  143.                        ---------------------
  144.  
  145.    Downloaded (read) readme's are left in the download directory.
  146.  
  147.    The download directory changes when you download by Drag & Drop.
  148.  
  149.    Files not found (except the readme's) are left selected.
  150.  
  151.    If HTTPresume is aborted before the file has finished being downloaded
  152.    you will just have to try again or use HTTPresume for what it was
  153.    designed for. Read HTTPresume docs for all about that.
  154.  
  155.  
  156. *** Setting up **
  157.   
  158.   o  Copy the file in the  Button drawer to the Dopus5:Button drawer.
  159.   o  Copy the files in the Image  drawer to the Dopus5:Image drawer.
  160.   o  Copy the file in the  ARexx  drawer to the Dopus5:ARexx drawer.
  161.  
  162.   o  READ THE HEADER IN HTTPlister.rexx for more info as THERE ARE
  163.      VARIABLE VALUES TO BE SET there.
  164.  
  165.   o  Edit the FilterOut string in HTTPlister.rexx.. for the aminet
  166.      file dirs you DON'T want listed.
  167.  
  168.   I have included the file 'aminet_TREE' in this archive to refer to
  169.   when compiling the list of aminet file dirs to filter out.
  170.  
  171.   I have also included the ARexx script 'YAM2HTTPlister.rexx' for getting
  172.   a subscribed RECENT file loaded into the lister from YAM.
  173.   
  174. Note!
  175.  * This is strictly USE AT YOUR OWN RISK.
  176.  * This has only been tested with Directory Opus 5.661 Magellan and
  177.  * HTTPResume 1.3.
  178.  * The names listed in the lister are only pseudo-files and can't be
  179.  * treated as you would other file names in normal listers. Only apply
  180.  * the actions that I outline and it should all work OK.
  181.   
  182. Enjoy.
  183.                              ******
  184.